3. Properties

3.06 the ScrollTop of member

Syntax:
set the ScrollTop of member whichcastmember = (integer value)
set x = the ScrollTop of member "html"

Purpose:
This property is used to get or set the top of the text display of the #html cast member.

The values could range between 0 (top position) and the maximium scroll position, which is evaluated as "the TxtHeight of member" minus "the PageHeight of member". If you pass values higher than the maximum scroll position, the value is set to the maximum scroll position.

The display scrolls to the desired value. The values are measured in pixels. The setting of the property "the ScrollSmooth of member" is ignored, when the ScrollTop is set from the message window.

This property can be tested and set.

Notes:

• The default is a value of 0 (top),
• the value is an integer,
• changing this value causes the cast member to (partly) redraw its contents,
• when smooth scrolling is active (scrollsmooth > 0) then setting the scrolltop will set an internal value where the xtra has to scroll to, but the scrolltop property has the value of the actual scrolltop position. This value is changing while the scrolling is performed.

See also:

• the ScrollBar of member
• the ScrollSmooth of member
• the Margin of member
• the TxtHeight of member
• the PageHeight of member